home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3c / mld.z / mld
Encoding:
Text File  |  2001-04-17  |  11.3 KB  |  199 lines
  1.  
  2.  
  3.  
  4. mmmmlllldddd((((3333))))                                                                  mmmmlllldddd((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      mld_create, mld_destroy, process_mldlink, process_cpulink, numa_acreate -
  10.      memory locality domain operations
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ppppmmmmoooo....hhhh>>>>
  15.  
  16.      ppppmmmmoooo____hhhhaaaannnnddddlllleeee____tttt mmmmlllldddd____ccccrrrreeeeaaaatttteeee((((iiiinnnntttt rrrraaaaddddiiiiuuuussss,,,, lllloooonnnngggg ssssiiiizzzzeeee))))
  17.  
  18.      iiiinnnntttt mmmmlllldddd____ddddeeeessssttttrrrrooooyyyy((((ppppmmmmoooo____hhhhaaaannnnddddlllleeee____tttt mmmmlllldddd____hhhhaaaannnnddddlllleeee))))
  19.  
  20.      iiiinnnntttt pppprrrroooocccceeeessssssss____mmmmllllddddlllliiiinnnnkkkk((((ppppiiiidddd____tttt ppppiiiidddd,,,, ppppmmmmoooo____hhhhaaaannnnddddlllleeee____tttt mmmmlllldddd____hhhhaaaannnnddddlllleeee,,,, rrrrqqqqmmmmooooddddeeee____tttt rrrrqqqqmmmmooooddddeeee))))
  21.  
  22.      iiiinnnntttt pppprrrroooocccceeeessssssss____ccccppppuuuulllliiiinnnnkkkk((((ppppiiiidddd____tttt ppppiiiidddd,,,, ppppmmmmoooo____hhhhaaaannnnddddlllleeee____tttt mmmmlllldddd____hhhhaaaannnnddddlllleeee,,,, ccccppppuuuuiiiidddd____tttt llllccccppppuuuuiiiidddd,,,, rrrrqqqqmmmmooooddddeeee____tttt rrrrqqqqmmmmooooddddeeee))))
  23.  
  24.      vvvvooooiiiidddd**** nnnnuuuummmmaaaa____aaaaccccrrrreeeeaaaatttteeee((((ppppmmmmoooo____hhhhaaaannnnddddlllleeee____tttt mmmmlllldddd,,,, ssssiiiizzzzeeee____tttt aaaarrrreeeennnnaaaa____ssssiiiizzzzeeee,,,, ssssiiiizzzzeeee____tttt ppppaaaaggggeeee____ssssiiiizzzzeeee))))
  25.  
  26.  
  27. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.      _mmmm_llll_dddd______cccc_rrrr_eeee_aaaa_tttt_eeee creates a memory locality domain.
  29.  
  30.      _mmmm_llll_dddd______dddd_eeee_ssss_tttt_rrrr_oooo_yyyy destroys a memory locality domain.
  31.  
  32.      _pppp_rrrr_oooo_cccc_eeee_ssss_ssss______mmmm_llll_dddd_llll_iiii_nnnn_kkkk attaches a process to an MLD. When a process is attached
  33.      to an MLD, the process scheduler tries to activate the process on a CPU
  34.      in the node where the MLD has been placed.
  35.  
  36.      _pppp_rrrr_oooo_cccc_eeee_ssss_ssss______cccc_pppp_uuuu_llll_iiii_nnnn_kkkk attaches a process to a specific CPU within the node that
  37.      the MLD is placed on. The CPU number is relative to the node, for example
  38.      on an Origin 3000 with a fully populated node the CPU numbering is 0-3.
  39.      On an Origin 2000 with a fully populated node, the CPU numbering is 0-1.
  40.      If a CPU is disabled on that node, then the CPU numbering is re-ordered
  41.      at boot time to always count up consecutively from 0. For example if an
  42.      Origin 3000 had a node with only 3 CPUs, the CPU numbering regardless of
  43.      which CPU is disabled would be 0,1,2.  This operation forces a process to
  44.      always run on the same CPU using `MP_MUSTRUN' (see sysmp(2)).
  45.  
  46.      _nnnn_uuuu_mmmm_aaaa______aaaa_cccc_rrrr_eeee_aaaa_tttt_eeee creates an arena for memory allocation on a specific MLD.
  47.  
  48.      _mmmm_llll_dddd______cccc_rrrr_eeee_aaaa_tttt_eeee will fail and a MLD will not be created if one or more of the
  49.      following are true:
  50.  
  51.      _EEEE_FFFF_AAAA_UUUU_LLLL_TTTT         Arguments could not be copied into kernel space.
  52.  
  53.      _EEEE_NNNN_OOOO_MMMM_EEEE_MMMM         No memory or kernel table space is available to create and
  54.                     hold the MLD.
  55.  
  56.      _EEEE_NNNN_OOOO_TTTT_SSSS_UUUU_PPPP        Memory locality domains are not supported on this system
  57.                     architecture.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmlllldddd((((3333))))                                                                  mmmmlllldddd((((3333))))
  71.  
  72.  
  73.  
  74.      _mmmm_llll_dddd______dddd_eeee_ssss_tttt_rrrr_oooo_yyyy will fail and no MLD will be destroyed if one or more of the
  75.      following are true:
  76.  
  77.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         The _mmmm_llll_dddd______hhhh_aaaa_nnnn_dddd_llll_eeee is invalid.
  78.  
  79.      _EEEE_NNNN_OOOO_TTTT_SSSS_UUUU_PPPP        Memory locality domains are not supported on this system
  80.                     architecture.
  81.  
  82.      _pppp_rrrr_oooo_cccc_eeee_ssss_ssss______mmmm_llll_dddd_llll_iiii_nnnn_kkkk will fail and the process will not be attached to an MLD
  83.      if one or more of the following are true:
  84.  
  85.      _EEEE_DDDD_EEEE_AAAA_DDDD_LLLL_KKKK        The operation would cause a deadlock to occur.
  86.  
  87.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         The _mmmm_llll_dddd______hhhh_aaaa_nnnn_dddd_llll_eeee is invalid or does not exist.
  88.  
  89.      _EEEE_NNNN_OOOO_TTTT_SSSS_UUUU_PPPP        Memory locality domains are not supported on this system
  90.                     architecture.
  91.  
  92.      _EEEE_SSSS_RRRR_CCCC_HHHH          The specified _pppp_iiii_dddd does not exist.
  93.  
  94.      _EEEE_XXXX_DDDD_EEEE_VVVV          The MLD has not been placed. (Call _mmmm_llll_dddd_ssss_eeee_tttt______pppp_llll_aaaa_cccc_eeee_((((_3333_cccc_))))
  95.                     first.)
  96.  
  97.      _pppp_rrrr_oooo_cccc_eeee_ssss_ssss______cccc_pppp_uuuu_llll_iiii_nnnn_kkkk will fail and the process will not be attached to an MLD
  98.      if one or more of the following are true:
  99.  
  100.      _EEEE_DDDD_EEEE_AAAA_DDDD_LLLL_KKKK        The operation would cause a deadlock to occur.
  101.  
  102.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         The specified mld_handle is invalid or does not exist.
  103.  
  104.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         The cpulink is attempted on a CPU which was not present.
  105.  
  106.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         The pid is part of a Pthreaded application, which is not
  107.                     supported by MP_MUSTRUN.
  108.  
  109.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         The process is already resides on a 'mustrun' CPU and is
  110.                     not allowed to move to another CPU.
  111.  
  112.      _EEEE_NNNN_OOOO_TTTT_SSSS_UUUU_PPPP        Memory locality domains are not supported on this system
  113.                     architecture.
  114.  
  115.      _EEEE_PPPP_EEEE_RRRR_MMMM          The user does not have adequate permission to execute the
  116.                     sysmp(2) system call MP_MUSTRUN command.
  117.  
  118.      _EEEE_PPPP_EEEE_RRRR_MMMM          The cpuset does not allow the process to run on the
  119.                     selected MLD and CPU.
  120.  
  121.      _EEEE_SSSS_RRRR_CCCC_HHHH          The specified _pppp_iiii_dddd does not exist.
  122.  
  123.      _EEEE_XXXX_DDDD_EEEE_VVVV          The MLD has not been placed. (Call _mmmm_llll_dddd_ssss_eeee_tttt______pppp_llll_aaaa_cccc_eeee_((((_3333_cccc_))))
  124.                     first.)
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. mmmmlllldddd((((3333))))                                                                  mmmmlllldddd((((3333))))
  137.  
  138.  
  139.  
  140.      _nnnn_uuuu_mmmm_aaaa______aaaa_cccc_rrrr_eeee_aaaa_tttt_eeee will fail and no memory arena will be created (and set
  141.      _eeee_rrrr_rrrr_nnnn_oooo) under the same circumstances that _aaaa_cccc_rrrr_eeee_aaaa_tttt_eeee_((((_2222_)))) will fail. It will
  142.      also fail and no memory arena will be created if one or more of the
  143.      following are true:
  144.  
  145.      _EEEE_FFFF_AAAA_UUUU_LLLL_TTTT         Arguments could not be copied into kernel space.
  146.  
  147.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         The specified MLD is invalid.
  148.  
  149.      _EEEE_NNNN_OOOO_TTTT_SSSS_UUUU_PPPP        Memory locality domains are not supported on this system
  150.                     architecture.
  151.  
  152.      _EEEE_SSSS_RRRR_CCCC_HHHH          The specified MLD does not exist.
  153.  
  154. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  155.      acreate(2), numa(5), mmci(5), mldset(3c), pm(3c), amalloc(3p), sysmp(2),
  156.      migration(3c), pminfo(3c).
  157.  
  158. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  159.      Upon successful completion, _mmmm_llll_dddd______cccc_rrrr_eeee_aaaa_tttt_eeee returns a value of type
  160.      pmo_handle_t.  Otherwise, a value of -1 is returned and _e_r_r_n_o is set to
  161.      indicate the error.
  162.  
  163.      Upon successful completion, _mmmm_llll_dddd______dddd_eeee_ssss_tttt_rrrr_oooo_yyyy, _pppp_rrrr_oooo_cccc_eeee_ssss_ssss______mmmm_llll_dddd_llll_iiii_nnnn_kkkk, and
  164.      _pppp_rrrr_oooo_cccc_eeee_ssss_ssss______cccc_pppp_uuuu_llll_iiii_nnnn_kkkk return 0.  Otherwise, a value of -1 is returned and _e_r_r_n_o
  165.      is set to indicate the error.
  166.  
  167.      Upon successful completion, _nnnn_uuuu_mmmm_aaaa______aaaa_cccc_rrrr_eeee_aaaa_tttt_eeee returns a pointer to the memory
  168.      arena which has been created.  Otherwise NULL will be returned and _e_r_r_n_o
  169.      is set to indicate the error.
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.